home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / GNU / oleo_src.lha / src / INSTALL < prev    next >
Encoding:
Text File  |  1992-07-27  |  5.9 KB  |  169 lines
  1.     Copyright (C) 1990 Free Software Foundation, Inc.
  2.  
  3. This file is part of Oleo, the GNU Spreadsheet.
  4.  
  5. Oleo is free software; you can redistribute it and/or modify
  6. it under the terms of the GNU General Public License as published by
  7. the Free Software Foundation; either version 1, or (at your option)
  8. any later version.
  9.  
  10. Oleo is distributed in the hope that it will be useful,
  11. but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13. GNU General Public License for more details.
  14.  
  15. You should have received a copy of the GNU General Public License
  16. along with Oleo; see the file COPYING.  If not, write to
  17. the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  18.  
  19.  
  20.  
  21. Note that oleo still generates lots of warning messages.  They can usually
  22. be ignored.  In patictlar, all the complaints about unreached statements in
  23. eval.c, and the complaints about too-large floating-point numbers can be
  24. ignored.
  25.  
  26.             System Dependent Configuration
  27.  
  28. If your _doprnt() doesn't correctly interpret %+d you may hve to use the
  29. one from the freed 4.3 BSD sources. (Included.)
  30.  
  31. If you don't have random(), you will have to use the one from the freed 4.3 BSD
  32. sources.  (Also included.)
  33.  
  34.  
  35.         System configuration options:
  36. -DSYSV
  37.     Define this if you are using any version of System Five.
  38.     This causes oleo to expect the SysV version of curses and
  39.     the SysV terminal driver.
  40.  
  41. -DNO_UALARM
  42.     Define this if your system lacks the ualarm() system call.
  43.  
  44. -DSETITIMER
  45.     Define this if your system lacks ualarm(), but has
  46.     setitimer().  (Also define -DNO_UALARM.)
  47.  
  48. -DNO_RINT
  49.     Define this if your C math library does not have the rint()
  50.     function.  This is needed on most SysV and MSDOS systems.
  51.  
  52. -DNO_RENAME
  53.     Define this if your system lacks the rename() system call.
  54.  
  55. -DNEED_VPRINTF
  56.     Define if your system lacks vprintf(), vfprintf(), and vsprintf(),
  57.     but does have a working _doprnt().  If you lack both _doprnt(), and
  58.     the v*printf() functions, you'll have to write your own replacements.
  59.  
  60. -DI_IOCTL
  61.     This option causes io_term.c to #include <sys/ioctl.h>, which contains
  62.     the information needed to turn on asyncronous IO on HPUX systems.
  63.  
  64. -DI_STDTYPES
  65.     This option causes oleo to include <sys/stdtypes.h>
  66.     This is needed on some sunos 4.1 systems.
  67.  
  68. -DI_STDDEF
  69.     This option causes oleo to include <stddef.h>  This should be used on
  70.     __STDC__ compliant systems.
  71.  
  72. -DI_SYSTYPES
  73.     This option causes oleo to include <sys/types.h>, and should be used
  74.     on non-ansi systems.
  75.  
  76.         Compile-time options:
  77.  
  78. -DA0_REFS
  79.     if Oleo is compiled with this option, it will use Visi-Calc
  80.     style cell references [A-ZZZ]nnn, instead of the default,
  81.     which is Multiplan style RxxCyy.
  82.  
  83. -DSPLIT_REFS
  84.     Instead of using the current reference-counting shared
  85.     reference-structures, use a (simpler) (but usually slower!)
  86.     one-structure-per-cell scheme.  This is usually only for
  87.     debugging the spreadsheet.
  88.  
  89. -DTEST
  90.     Include code for debugging-mode, and also include lots of
  91.     internal-consistency checks, etc.  Defining this usually
  92.     doesn't hurt, except on MS-LOS, where every byte counts.
  93.  
  94. -DUSE_DLD
  95.     If you're on a BSD system, oleo can be compiled to
  96.     dynamically load the functions that implement
  97.         the save-file formats,
  98.         spreadsheet formula functions,
  99.         spreadsheet keyboard functions,
  100.         and the spreadsheet keymaps.
  101.     Unfortunately, this code only works on BSD systems.
  102.  
  103.     Before you can use dld with oleo, you will need to apply the
  104.     patch found in 'dld.pch'.
  105.  
  106.     If you don't have dld, it can be obtained by anonymous FTP from
  107.     prep.ai.mit.edu and probably other archive sites as well.
  108.  
  109. -DREVERSE
  110.     This option causes oleo to reverse the internal representation that
  111.     it uses for storing rows and columns.  It is intended mainly for
  112.     debuggind and performance testing.
  113.  
  114. -DSMALLEVAL
  115.     This option is intended to allow eval.c to compile on MS-LOS machines
  116.     where the compiler would otherwise run out of memory.
  117.  
  118. -DBITS_PER_CELLREF=16
  119.     If this option is used, oleo uses 16-bit integers for cell addresses
  120.     instead of 8-bit ones.  65535 rows and columns should be more than
  121.     enough for most purposes, especially since no 32-bit machine will
  122.     have enough virtual memory to fill that region.
  123.  
  124.  
  125.         To compile on a BSD system:
  126.  
  127.     Decide if you want to use Multiplan style RdigitCdigit or VisiCalc
  128. style LETTERSdigits style cell references.  If you prefer the latter, modify
  129. the Makefile to include -DA0_REFS on the CFLAGS line.
  130.  
  131.     If you're using Multiplan style references, find out if you _doprnt()
  132. routine supports %+d correctly.  Decimal numbers printed with this format
  133. should have either a + sign (if positive) or a -sign (if negative).  If you
  134. _doprnt() is broken, you may be able to use one from the free 4.3BSD
  135. distribution.  A copy of that file is included in this distribution.
  136.  
  137.     Find out if your C compiler can handle large switch statements.  GCC
  138. (with Gas) can.  Some other compilers can't.  Some of those that can't
  139. actually bother to tell you that they're producing incorrect code.  If your
  140. compiler doesn't, the spreadsheet will crash by branching to a semi-random
  141. location in eval_expression().  If your compiler has this problem, compile
  142. eval.c with the -DSMALLEVAL option.
  143.  
  144.     If you can't get the definitions of __plinf or, __neinf past your
  145. compiler, you may have to resort to assembly language.
  146.     Aside from the details above, you should simply be able to type
  147. 'make', and oleo should build.
  148.  
  149.  
  150.         To compile on a MS-DOS system with Turbo C version 2.0:
  151.  
  152.     Copy all the files to your PC.
  153.  
  154.     Convert the files from UNIX ^J terminated lines to MS-DOS ^M^J
  155. terminated lines.
  156.  
  157.     Decide what to do about cell references, as above.  Modify
  158. makefile.trc to include -DA0_REFS if appropriate.
  159.  
  160.     Type 'make -f makefile.trc'.  This makefile is sufficiently
  161. simple that even Turbo C's wimpy make should be able to deal with it.
  162.  
  163.  
  164.         To compile on a SYSV system:
  165.  
  166.     Follow the instructions for a BSD system, but include -DSYSV in the
  167. CFLAGS line.  Oleo on a pure SYSV system is *not* well tested.
  168.  
  169.